|
|
| .NET Framework Class Library |
| LazyInitializer..::.EnsureInitialized<(Of <(T>)>) Method (T%) |
| LazyInitializer Class See Also Send Feedback |
Initializes a target reference type with the type's default constructor if the target has not
already been initialized.
Namespace:
System.Threading
Assembly:
System.Threading (in System.Threading.dll)
Syntax
| Visual Basic (Declaration) |
|---|
Public Shared Function EnsureInitialized(Of T As Class) ( _ ByRef target As T _ ) As T |
| C# |
|---|
public static T EnsureInitialized<T>( ref T target ) where T : class |
Parameters
- target
- Type:
T
%
A reference of type T to initialize if it has not already been initialized.
Type Parameters
- T
- The refence type of the reference to be initialized.
Return Value
The initialized reference of type T.Remarks
This method may only be used on reference types. To ensure initialization of value types, see other overloads of EnsureInitialized.
This method may be used concurrently by multiple threads to initialize target. In the event that multiple threads access this method concurrently, multiple instances of T may be created, but only one will be stored into target. In such an occurrence, this method will not dispose of the objects that were not stored. If such objects must be disposed, it is up to the caller to determine if an object was not used and to then dispose of the object appropriately.
Exceptions
| Exception | Condition |
|---|---|
| System..::.MissingMemberException | Type T does not have a default constructor. |
| System..::.MemberAccessException | Permissions to access the constructor of type T were missing. |
See Also
